Skip to content

Conversation

@llucax
Copy link
Contributor

@llucax llucax commented Jun 13, 2024

  • Import implementation from the SDK v1.0.0rc601
  • Add an introduction and example to the package documentation
  • Include the package documentation in the website home
  • Add a link to the documentation in the README

@llucax llucax requested a review from a team as a code owner June 13, 2024 14:16
@llucax llucax requested a review from shsms June 13, 2024 14:16
@llucax llucax self-assigned this Jun 13, 2024
@github-actions github-actions bot added part:docs Affects the documentation part:tests Affects the unit, integration and performance (benchmarks) tests part:tooling Affects the development tooling (CI, deployment, dependency management, etc.) part:code Affects the code in general labels Jun 13, 2024
"""Types for holding quantities with units."""
"""Types for holding quantities with units.
This library provide types for holding quantities with units. The main goal is to avoid
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe remove the first sentence as it is equal to the headline

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a title/summary, like with git commits. There are some options or places where only the summary line is shown.

llucax added 4 commits June 13, 2024 16:19
The only difference with the SDK is the files are split to have one per
quantity type, to have more manageable files.

Also `_NoDefaultConstructible` was renamed to `NoDefaultConstructible`,
as it is used outside the module it is defined in (`_quantity.py`). It
is not exported in `__init__.py` though. In the future it should
probably be moved to some core library.

The tests are also imported from the SDK but kept in one file, as there
are many tests that use multiple quantity types to compose them.

Signed-off-by: Leandro Lucarella <[email protected]>
@llucax llucax added part:docs Affects the documentation part:tests Affects the unit, integration and performance (benchmarks) tests part:tooling Affects the development tooling (CI, deployment, dependency management, etc.) type:enhancement New feature or enhancement visitble to users part:code Affects the code in general and removed part:docs Affects the documentation part:tests Affects the unit, integration and performance (benchmarks) tests part:tooling Affects the development tooling (CI, deployment, dependency management, etc.) part:code Affects the code in general labels Jun 13, 2024
@llucax llucax added this to the v0.1.0 milestone Jun 13, 2024
@Marenz Marenz added the cmd:skip-release-notes It is not necessary to update release notes for this PR label Jun 13, 2024
Marenz
Marenz previously approved these changes Jun 13, 2024
We'll release v1.0.0 soon, so we should update the edit URL to point to
the v1.x.x branch instead of the v0.x.x branch.

Signed-off-by: Leandro Lucarella <[email protected]>
@llucax
Copy link
Contributor Author

llucax commented Jun 13, 2024

I updated the branch to v1.x.x to follow the suggestion in frequenz-floss/frequenz-sdk-python#852. I think this is mature enough to go with a v1.0.0. If we want to make breaking changes we can start a new v2.x.x branch, but it will make us asses the cost-benefit from doing that and avoid cheap breaking changes...

Signed-off-by: Leandro Lucarella <[email protected]>
@llucax
Copy link
Contributor Author

llucax commented Jun 13, 2024

Added release notes assuming v1.0.0 will be released after this is merged.

@llucax llucax requested a review from Marenz June 13, 2024 14:34
@llucax llucax added this pull request to the merge queue Jun 13, 2024
Merged via the queue into frequenz-floss:v1.x.x with commit 7e65ca3 Jun 13, 2024
@llucax llucax deleted the sdk-import branch June 13, 2024 21:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cmd:skip-release-notes It is not necessary to update release notes for this PR part:code Affects the code in general part:docs Affects the documentation part:tests Affects the unit, integration and performance (benchmarks) tests part:tooling Affects the development tooling (CI, deployment, dependency management, etc.) type:enhancement New feature or enhancement visitble to users

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants